home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBK.ADF / Terminal / HandShake.doc < prev    next >
Text File  |  1991-02-10  |  47KB  |  1,030 lines
  1. -----------------
  2.  
  3.       /\/\
  4.      / /  \
  5.  ---/ / /\ \-----
  6.       \/  \ 
  7.  Hand     / Shake  Version 2.20b
  8.  ---\    / /-----
  9.      \  / /
  10.       \/\/
  11.  
  12. -----------------
  13.  
  14. HandShake V2.20c. Summary of Features.
  15.  
  16. *** Important Note ***
  17.  
  18. The .parms file format file for this release has changed for release
  19. v2.20a please see the "WHAT PROBLEMS ARE THERE WITH HandShake:
  20. section in this document. This describes how to convert from the old
  21. format to the new format.
  22.  
  23. If you want to see how this version of HandShake has changed from the
  24. previous versions please refer to the Version History section at the
  25. end of this document.
  26.  
  27. WHAT IS IT?
  28.  
  29. HandShake is the copyrighted property  ( (c) 1987, 1988, 1989, 1990)
  30. of Eric Haberfellner
  31.  
  32. HandShake is a Full featured VT52/100/102/220 terminal emulator for
  33. those people who really need it. I have taken great pains to support
  34. the full VT102 spec (VT102 is a superset of VT100) and most of the
  35. VT220 spec. I have no real way currently to test the full
  36. functionality of the VT220 emulation, so I am relying on my users to
  37. point out any errors. Please detail any problems that you find, and I
  38. will fix them for the next release.
  39.  
  40. See the review included in the ARC file.
  41.  
  42. I take no responsibility for the proper functioning of this program
  43. or for any damage to you or your business that may be caused by this
  44. program. (obligatory disclaimer.)
  45.  
  46. IMPORTANT NOTE ABOUT DISTRIBUTION AND SHAREWARE
  47.  
  48. Feel free to use and distribute this program as you like, as long as
  49. it is not for commercial use. If you like it, use it and want to see
  50. it get better, please send a contribution of $35.00 to the address
  51. listed in the program's "About.." requester. Commercial users are
  52. urged to contact the author. Please do not alter or rename the
  53. distribution ARC file in any way if you pass it along or post it on a
  54. bulletin board. The current HandShake distribution ARC file is called
  55. HDSK220a.arc. This way people can tell what version of HandShake is
  56. on a BBS.
  57.  
  58. Future enhancements that I would like to do include multiple number
  59. dialing, etc, however I will have to see an increase in user support
  60. if I am going to do these things. If you like this product and use it
  61. send a contribution. This is not free software. It is SHAREWARE it
  62. has a cost that you are expected to pay if you use it. Let me know
  63. what features are important to you. If you feel that there are
  64. features missing that you would like to see, please let me know that
  65. as well. How would you feel if HandShake got even bigger? Is size a
  66. problem? How do you feel about overlays? Would having to do an assign
  67. in your startup-sequence make HandShake unusable or cumbersome to
  68. you?
  69.  
  70. COME ON PEOPLE TALK TO ME! I know that you are out there and using
  71. HandShake. If the support does not pick up I will have to start
  72. releasing crippled versions of HandShake, and only send the full
  73. featured non-freely distributable versions to people who contribute.
  74. I do not want to have to do this, it is contrary to my beliefs about
  75. SHAREWARE and people supplying quality software to others for low
  76. cost. I know it is a nuisance to have to walk to your chequebook and
  77. fill out a cheque, address an envelope, and mail it, but prove that
  78. you are someone that cares about SHAREWARE and wants it to continue.
  79. Make a statement, not just for me and my program, but for other
  80. SHAREWARE products that you use as well. The people who write these
  81. programs are highly skilled professionals in most cases who want to
  82. help other users. They deserve your support!
  83.  
  84. WHAT IS THIS DOCUMENT?
  85.  
  86. This document is a quick description of the features of HandShake
  87. paying particular attention to the less obvious aspects of HandShake
  88. so that an experienced user will be able to use the program. This
  89. document assumes that the user has experience with terminal programs
  90. and the Amiga. Especially the Intuition user interface ( Menus,
  91. requesters, etc. )
  92.  
  93. Please also see the file HandShake_AREXX.doc which describes the
  94. HandShake-AREXX interface.
  95.  
  96. WHAT IS THIS DOCUMENT NOT?
  97.  
  98. This document is not a course on telecomunications and modem usage it
  99. assumes some familiarity with telecommunications and terminal
  100. programs. If you are not familiar with terminal programs or the Amiga
  101. user interface, find a friend who is and ask him/her to help you.
  102.  
  103. WHAT DO YOU NEED TO RUN HandShake?
  104.  
  105. An Amiga with 512K or more. At least version 1.2 of Kickstart and
  106. Workbench. THIS PROGRAM WILL NOT WORK WITH VERSION 1.1 OR EARLIER OF
  107. AMIGADOS. Hardware to connect to the other computer. This may consist
  108. of only a cable if you are locally wired, or a cable and a modem if
  109. you are accessing the other computer over the telephone. This program
  110. does work with memory expanded beyond 512K.
  111.  
  112. To make full use of the features of HandShake, you will probably need
  113. more than 512K of memory. Also, HandShake can take advantage of the
  114. following programs if they are running in your system. They are not
  115. required to run HandShake however:
  116.  
  117.         AREXX - If AREXX is available, you can use it to write macros
  118.                 which give HandShake a very powerful script language.
  119.                 See the file HandShake_AREXX.doc for full details.
  120.         CONMAN- If the CONMAN console editor/manager is available,
  121.                 HandShake can use it to open DOS command windows
  122.                 on the HandShake screen.
  123.         WSHELL- If WSHELL is installed, HandShake will try to open
  124.                 a WSHELL window when asked to open a DOS window on
  125.                 its screen. If you Don't have WSHELL HandShake will
  126.                 open an AmigaShell or CLI window.
  127.                 
  128.         NOTE: All of the above tools were developed by Bill Hawes.
  129.               AREXX and WSHELL are commercial products and should
  130.               be available at your dealer, or can be bought from
  131.               Mr. Hawes directly. CONMAN is a public domain program
  132.               and is probably on your favourite bulletin board. It
  133.               also comes with the above products when you buy them.
  134.               I am in no way affiliated with Mr. Hawes. I just think
  135.               that he makes great tools.
  136.  
  137.         XPR   - HandShake now makes use of the XPR facility
  138.                 (developed by Willy Langeveld) to support external
  139.                 file transfer protocols. For those of you who who
  140.                 have been asking for ZMODEM support, it is now
  141.                 available as an external protocol library available
  142.                 from your favourite bulletin board.
  143.  
  144. WHY SHOULD YOU USE HandShake?
  145.  
  146. If you have a requirement for FULL VT52/100/102/220 compatability and
  147. have not been satisfied by other programs which only do half the job,
  148. this is probably the program you have been looking for!
  149.  
  150. Here is a list of some of the features that HandShake offers:
  151.  
  152.     - Full 24/48 line display with title bar enabled! No more turning
  153.       the title bar on and off to see all 24 lines.
  154.  
  155.     - Full VT52 support. Every VT100 has a VT52 inside of it. So does
  156.       HandShake -- right down to the VT52 graphics character set.
  157.  
  158.     - VT102/220 Edit mode. Local insert and deletes.
  159.  
  160.     - VT220 Emulation. Including downloadable character sets. It
  161.       works great with VMS APL.
  162.       
  163.     - VT220 7 or 8 bit control mode. Selectable erase etc.
  164.     
  165.     - Full featured AREXX support. HandShake is both an AREXX command
  166.       host and an AREXX function host. See the file
  167.       HandShake_AREXX.doc for full details.
  168.  
  169.     - Smooth or Jump scrolling.
  170.  
  171.     - Block or Underline see through reverse video cursor. Blinking
  172.       or non-blinking
  173.  
  174.     - Full VT100 Special Graphics Character Set.
  175.  
  176.     - Full double height and double width characters.
  177.  
  178.     - 132 character per line mode. It may be necessary to run
  179.       preferences and use the screen centering gadget a little to the
  180.       left in order to see the last few columns in 132 column mode.
  181.  
  182.     - Double height and width characters in 80 and 132 column mode.
  183.  
  184.     - All character modes. Normal, Bold, Reverse video, Underline and
  185.       Blinking in any combination.
  186.       
  187.     - Optional color mode. Uses ANSI color selection codes. Handy for
  188.       bulletin boards which support color.
  189.  
  190.     - Full keyboard support. This includes VT52 mode. HandShake
  191.       handles the escape sequences to turn auto repeat on and off and
  192.       lock the keyboard. No more run away cursors while in EDT under
  193.       VMS etc.
  194.     
  195.     - As of release 1.60a HandShake supports the additional Amiga
  196.       500/2000 numeric keypad keys.
  197.  
  198.     - ASCII file transfer mode with user definable end-of-line
  199.       translation for both sending and receiving. No more carriage
  200.       returns in your received files (unless you want them).
  201.  
  202.     - XMODEM, XMODEM/CRC, YMODEM, YMODEM Batch, KERMIT/TEXT, KERMIT/8
  203.       BIT BINARY and KERMIT/7 bit BINARY protocols for binaryfile
  204.       transfers.
  205.  
  206.     - External Protocol support. Handshake supports XPR protocol
  207.       libraries. This allows Handshake to use protocols written by
  208.       other authors. This is how ZMODEM and other protocols which are
  209.       not internal to Handshake are supported.
  210.  
  211.     - Non-display mode lets Handshake run in the background as an
  212.       AREXX communications command server.
  213.  
  214.     - User settable Font. Handshake can use any 8 x 8 font. This font
  215.       will be scaled to provide 132 column and double width, double
  216.       height fonts.
  217.  
  218.     - Six user definable function keys.
  219.     
  220.     - Dialing Support with a 20 Phone number Directory. Optional auto
  221.       redialing is available. System characteristics ( baud rate,
  222.       data bits, parity, stop bits ) can be specified in the dialing
  223.       directory entry. Auto redial can be specified in the directory
  224.       entry. This dialing mode is geared to Hayes compatible modems,
  225.       although the user can specify the dialing prefix ( ATDP or
  226.       ATE0DT, etc. ).
  227.  
  228.     - Fast! Using a 95K text file captured from a VAX which was then
  229.       sent to HandShake from a local microcomputer, HandShake
  230.       maintained a throughput of 875 characters per second. This
  231.       means that HandShake can take characters as fast as your host
  232.       can send them at 7200 baud, and still look good at 9600. A real
  233.       VT100 can't keep up at 9600 baud either. You can use the
  234.       shareware BLITZFONTS program to get even better performance.
  235.       
  236.     - Complete Workbench integration. HandShake can be started from
  237.       the Workbench. As you save parameter files, icons are
  238.       optionally created. These icons can be used to invoke HandShake
  239.       later with the same paremeters. You can even specify a host to
  240.       dial immediately when the icon is invoked. This feature can be
  241.       turned off if you prefer the CLI and do not want .info files
  242.       cluttering up your disk.
  243.       
  244.     - The ability to capture screen images to an ASCII file or to a
  245.       printer. Just for you Toronto Real Estate Board Users. See, I
  246.       do listen to my users.
  247.       
  248.     - HandShake will optionally make use of the ARP file requester if
  249.       ARP.library is installed in the LIBS: directory of your
  250.       workbench disk.
  251.  
  252. WHAT PROBLEMS ARE THERE WITH HandShake?
  253. *
  254. * PLEASE READ THIS SECTION!!
  255. *
  256. Version 2.20a has a new .parms file format. A utility called CvtParms
  257. is provided to convert from the v2.12a (and before) format to the new
  258. format, the usage is as follows:
  259.     CvtParms oldfile.parms newfile.parms
  260. Simple eh? (We apologize for the inconvenience).
  261.  
  262. The VT220 mode does not support the Host Definable Keys feature. This
  263. will probably be in the next major release.
  264.  
  265. Line noise will sometimes select one of the special character sets
  266. (this happens with real VT100 terminals too). You can reselect the
  267. ASCII font by selecting the Terminal Type from the Terminal menu. For
  268. instance, if you are in VT102 mode, and you wish to reset the ASCII
  269. character set, just select the VT102 submenu.
  270.  
  271. HandShake takes up a lot of memory for its fonts and buffers.
  272. HandShake will run on a 512k system, but you may run into problems if
  273. you have a background utilities running (machii, virusx, etc). The
  274. best solution is to buy more memory. A 512k Amiga is really starving.
  275. However I intend to address this problem in a future release. Maybe a
  276. menu option to disable everything but the 80 column fonts.
  277.  
  278. You may find that you can not see the last two or three columns of
  279. 132 column mode. If this happens to you, run Preferences and move the
  280. screen centering gadget to the left a bit. This should fix the
  281. problem.
  282.  
  283. WHO DO YOU CALL WITH PROBLEMS, SUGGESTIONS, MAKE CONTRIBUTIONS TO
  284.  ETC?
  285.  
  286. Me!
  287.     Eric Haberfellner,
  288.     57 Glenwood Avenue,
  289.     Toronto, Ontario
  290.     CANADA
  291.     M6P 3C7
  292.  
  293.     Voice Phone (416) 604-2025 ( After Six P.M. EST please ).
  294.  
  295.     I am on available on BIX as ehaberfellner, and can be reached
  296.   Through USENET at ...utgpu!mnetor!becker!haberfellner!eric or
  297.   eric@haberfellner.
  298.  
  299. WHAT DO YOU NEED TO KNOW ABOUT HandShake TO USE IT NOW?
  300.  
  301. The follwing things about HandShake are not obvious so you should
  302. familiarize yourself with this section.
  303.  
  304.     * READ THIS NOTE.
  305.     * HandShake uses a 660 pixel wide screen instead of the usual 640
  306.     * pixels.
  307.     * This means that the HandShake extends 20 pixels further to the
  308.     * right Than most screens. It may not be possible to see the
  309.     *  screen depth arrangement gadgets at the right of the title bar
  310.     * or the last 3 or 4 columns of test in 132 column mode unless
  311.     * you run preferences and move the screen centering gadget a
  312.     * little to the left!!
  313.  
  314. Command line.
  315.  
  316.     HandShake can be invoked from the CLI. The general form of the
  317.   command line is illustrated below (parts in square brackets are
  318.   optional):
  319.  
  320.     HandShake [-n] [-p parameter_file_name] [-m AREXX_macro]
  321.     [destination_name]
  322.  
  323.     The -n switch will start up HandShake in its NODISPLAY mode. In
  324. this mode Handshake does not open a window or screen, but starts
  325. quietly in the background. This is useful for using Handshake as an
  326. AREXX communications command server.
  327.  
  328.     The parameter file name is the parameter file to be used, if none
  329.  is specified the default file HandShake.parms is used.
  330.  
  331.     The destination name is the name of the remote computer to be
  332.  dialed. This name must be one that appears in dialing directory of
  333.  the parameter file being used and must be spelled exactly the same
  334.  way it is spelled in the dialing directory entry (Case of characters
  335.  is not significant).
  336.  
  337.     If the name in the dialing diretory entry ends in a '*' or the
  338.  Auto Redial menu selection is set in the parameter file, HandShake
  339.  will keep dialing the number until a connection is made. If the name
  340.  in the dialing directory entry ends in a '*', do not include the '*'
  341.  on the command line when specifying the destination name.
  342.  
  343.     If this dialing directory entry appeared in the default file
  344.     HandShake.parms:
  345.  
  346.     555-1234:1200,8,n,1 Fred's BBS*
  347.  
  348.     The following command line could be used to call this BBS.
  349.  
  350.     HandShake "Fred's BBS"
  351.  
  352.     Note that the '"'s are necessary in this case because the name of
  353.     the BBS has a space in it.
  354.  
  355.     Here are a few more examples:
  356.  
  357.     HandShake -p universities.parms UCLA
  358.  
  359.     This would dial the phone number associated with the descriptor
  360.  UCLA in the parameter file universities.parms
  361.  
  362.     HandShake -p TymNet -m readmail BIX
  363.  
  364.     This would load the parameter file Tymnet.parms, then dial the
  365.     destination BIX and finally invoke the AREXX macro readmail.rexx.
  366.  
  367.     For a complete description of dialing directory entries, see the
  368.     discussion later in this section
  369.  
  370. Workbench.
  371.  
  372.    HandShake can also be invoked from the Workbench. There is an icon
  373. which looks like a terminal. Invoking this icon will cause HandShake
  374. to be invoked with the parameters from HandShake.parms, or if this
  375. file does not exist HandShake will use it's built in parameters.
  376.    
  377.    In the project menu there is an item "Create Icons". if you set
  378. this to "Yes" HandShake will create a telephone icon every time that
  379. you save the parameters. While HandShake is saving the parameters it
  380. will also prompt you for a dialing descriptor which if specified will
  381. be used as the initial dialing destination when the icon is invoked.
  382. If AREXX is running on your system, you will also be prompted to
  383. specify an optional AREXX startup macro.
  384.  
  385.    The initial dialing descriptor can be edited from the workbench by
  386. examining the icon that you wish to modify and editing or adding a
  387. Tool Types line of the form:
  388.  
  389.         DIALUP=Fred's BBS*
  390.    
  391.    The initial AREXX Macro can be edited from the workbench by
  392.    examining the icon that you wish to modify and editing or adding a
  393.    Tool Types line of the form:
  394.  
  395.         MACRO=readmail
  396.  
  397.    It is also possible to include a Tool Types line of the form:
  398.  
  399.         NODISPLAY
  400.  
  401.     This will build an icon whoch will start up HandShake in No Display mode.
  402.  
  403.    CLI users will probably want to keep the "Create Icons" option set
  404. to "No" so that their disks will not be cluttered with un-necessary
  405. .info files.
  406.  
  407. Keyboard.
  408.  
  409.     VT100 Keys                Amiga Keys
  410.     ----------                ----------
  411.     Arrow keys                Arrow keys
  412.     
  413.     F1 through F4             F1 through F4 on all Amaigas
  414.                    or
  415.     F1                        Keypad ( on Amiga 500/2000
  416.     F2                        Keypad ) on Amiga 500/2000
  417.     F3                        Keypad / on Amiga 500/2000
  418.     F4                        Keypad * on Amiga 500/2000
  419.     
  420.     Keypad 0 through 9        Keypad 0 through 9 on all Amigas
  421.     Keypad .                  Keypad . on all Amigas
  422.     Keypad -                  Keypad - on all Amigas
  423.     Keypad ,                  RIGHT_ALT key on all Amigas **Watch for                               this**
  424.                    or
  425.     Keypad ,                  Keypad + on Amiga 500/2000
  426.     
  427.     Keypad Enter              Keypad Enter on all Amigas
  428.     
  429.     
  430.     
  431.  
  432.     VT220 Keys                Amiga Keys
  433.     ----------                ----------
  434.     Arrow keys                Arrow keys
  435.     
  436.     F1 through F4             F1 through F4 on all Amaigas
  437.                    or
  438.     PF1                       Keypad ( on Amiga 500/2000
  439.     PF2                       Keypad ) on Amiga 500/2000
  440.     PF3                       Keypad / on Amiga 500/2000
  441.     PF4                       Keypad * on Amiga 500/2000
  442.  
  443.     F1-F4                     Do not transmit any key codes and are                               not currently mapped.
  444.     F5                        RIGHT-AMIGA B on all Amigas
  445.     F6                        SHIFTED F1 on all Amigas
  446.     F7                        SHIFTED F2 on all Amigas
  447.     F8                        SHIFTED F3 on all Amigas
  448.     F9                        SHIFTED F4 on all Amigas
  449.     F10                       SHIFTED F5 on all Amigas
  450.     F11                       Escape on all Amiags
  451.     F13                       Any SHIFTED Arrow key on all Amigas
  452.     F12                       Backspace on all Amigas
  453.     F14                       SHIFTED F6 on all Amigas
  454.     F17                       SHIFTED F7 on all Amigas
  455.     F18                       SHIFTED F8 on all Amigas
  456.     F19                       SHIFTED F9 on all Amigas 
  457.     F20                       SHIFTED F10 on all Amigas
  458.     
  459.     FIND                      SHIFTED-Keypad 7 on all Amigas
  460.     INSERT HERE               SHIFTED-Keypad 8 on all Amigas
  461.     REMOVE                    SHIFTED-Keypad 9 on all Amigas
  462.     SELECT                    SHIFTED-Keypad 4 on all Amigas
  463.     PREV SCREEN               SHIFTED-Keypad 5 on all Amigas
  464.     NEXT SCREEN               SHIFTED-Keypad 6 on all Amigas
  465.     
  466.     Keypad 0 through 9        Keypad 0 through 9 on all Amigas
  467.     Keypad .                  Keypad . on all Amigas
  468.     Keypad -                  Keypad - on all Amigas
  469.     Keypad ,                  RIGHT-ALT key on all Amigas **Watch for                               this**
  470.                    or
  471.     Keypad ,                  Keypad + on Amiga 500/2000
  472.     
  473.     Keypad Enter              Keypad Enter on all Amigas
  474.  
  475.     The Back space and Del keys can be reversed with a TERMINAL menu
  476.  option.
  477.  
  478. User Definable Function Keys.
  479.  
  480.     The function keys F5 through F10 are now user definable keys.
  481.  There is now a new menu item in the Porject menu, the "Function
  482.  keys" item. Selecting this option will cause the Function Key Edit
  483.  Requester to appear. Just type in the strings that you want the
  484.  fucntion keys to transmit. When you are finished, just select the
  485.  ALL DONE gadget.
  486.     
  487.     There are two other gadgets on the Function Key Edit Requester.
  488.  These allow the user to specify which characters in the transmit
  489.  strings should be used to represent the carriage return and line
  490.  feed keys. The default values are the '~' for carriage return and
  491.  '`' for line feed. Please note that in order to change these
  492.  charcters it is necessary to delete the character which appears in
  493.  the gadget before typing in the new one.
  494.     
  495.     The function key definitions are saved along with the phone
  496.  directory and other options the the selected HandShake parameter
  497.  file.
  498.  
  499. File Transfers.
  500.  
  501.     The "Receive/Transmit CR/LF as ..." menu options are only
  502.  applicable to the ASCII file transfer modes. These can be used to
  503.  translate end of line characters when sending to the other system.
  504.  For instance, when sending to a VAX which is receiving with the
  505.  CREATE command, you will want to send a carriage return to the  VAX
  506.  at the end of each line. Amiga text files have no carriage returns
  507.  in them so lines are terminated with line feed characters. By
  508.  selecting the Transmit LF as CR option HandShake will do the
  509.  conversion for you.
  510.  
  511.     
  512.     As of version 1.30b you no longer have to terminate ASCII Receive
  513.     (capture) mode in order to do a binary file transfer. HandShake
  514.     will automatically suspend cpature mode while the transfer is
  515.     taking place and will restart it when the transfer has completed.
  516.     
  517.     If you use the XMODEM, XMODEM/CRC or single file YMODEM binary
  518.     file transfer mode, be aware that the received file will probably
  519.     have to be truncated. This is because all files received by
  520.     XMODEM are a multiple of 128 bytes long. AmigaDos does not like
  521.     these extra bytes. There are several good public domain utilities
  522.     available to strip these bytes off the end of the file (TAILRID,
  523.     for one). If you send your files in ARC format then this is not a
  524.     problem.
  525.  
  526.     HandShake also supports the YMODEM Batch protocol and KERMIT.
  527.     Using these protocols lets you transfer multiple files in one
  528.     transfer, frees the receiving user from the necessity of having
  529.     to enter the name of the file being received, and results in
  530.     files that have the same length as the original file (No need to
  531.     chop extra bytes off the end of the file). HandShake does however
  532.     ask the receiving user to specify the directory path into which
  533.     the received files should be placed. This directory path MUST end
  534.     in a ":" or a "/". Some examples of valid directory paths are:
  535.     
  536.        df0:
  537.        df1:source/
  538.        source/
  539.        :source/
  540.        vd0:source/headers/
  541.        RAM:download_files/
  542.        my_files:               /* In this case my_files must be a
  543.                                   volume name or have been assigned
  544.                                   with the assign command.
  545.                                */
  546.     If you do not specify a directory path the files will be placed
  547.  in the current directory.
  548.     
  549.     When sending with YMODEM Batch protocol you can specify a file
  550.  name as usual, or use wildcards as well. Here are some sample YMODEM
  551.  Batch send file specifications:
  552.     
  553.        df0:source/my_file.c
  554.        ram:#?
  555.        df1:source/headers/#?.h
  556.        
  557.     You get the idea. YMODEM Batch or KERMIT will transfer all the
  558.  specified files to the receiver. It will send the file names, and
  559.  the file lengths as well.
  560.     
  561.     
  562.     HandShake now supports the KERMIT file transfer protocol. It is
  563.  used in much the same way as the YMODEM Batch protocol which also
  564.  supports multiple file transfers. There are three KERMIT modes.
  565.  KERMIT 8 bit Binary, KERMIT 7 bit Binary and KERMIT Text. Kermit 8
  566.  bit Binary requires you to be connected with the other computer with
  567.  8 data bits. It will not work with a seven bit connection. KERMIT 7
  568.  bit binary works with a 7 bit connection it uses the KERMIT binary
  569.  escaping feature. This should only be used if an 8 bit connection is
  570.  unavailable, since it can really slow down the transfer. KERMIT
  571.  Binary protocols do image transfers, the received or sent file is
  572.  bit for bit identical with the original. Kermit Text is used for
  573.  text files, and will work with either a 7 bit or 8 bit connection.
  574.  It should be used for text files only. The received files will have
  575.  no cariage returns at the end of the lines, only line feeds. If you
  576.  want the carriage returns, use one of the binary protocols
  577.  
  578.     As of version 2.20b, Handshake supports the XPR External protocol
  579.     facility. This will allow you to use any XPR file transfer
  580.     library which you can pick up for your favourite bulletin board.
  581.     Existing XPR libraries include ASCII, ZMODEM, KERMIT, and QUICKB.
  582.     There are probably others by now. Simply select the "External
  583.     Protocol" option from the "Binary Protocol" sub-menu. Handshake
  584.     will pop up a file requester asking you for the name of the
  585.     external protocol you wish to use. If you re using the ARP file
  586.     requester, a list will be displayed for you. Once you have
  587.     selected the protocol. You can customize its options by selecting
  588.     the "Init. External Protocol" menu item from the file transfer
  589.     menu. Once this is done, file transfers happen as for any of
  590.     HandShake's internal protocols.
  591.     
  592.     For the protocol transfers and for the ASCII Send, HandShake pops
  593.     up two windows, one in its own screen and one in the workbench
  594.     screen. These windows provide information on the progress of the
  595.     transfer. The one in the HandShake screen can be used to abort
  596.     the transfer just by clicking on the close gadget in the upper
  597.     left hand corner. The window in the Workbench screen is provided
  598.     so that during a long file transfer you can use your
  599.     multi-tasking Amiga to do other things and not have to keep
  600.     flipping back to HandShake to see if the transfer has completed.
  601.     
  602.     If you have the Audio Bell option enabled, You will hear a rising
  603.     sequence of notes for a successfull file transfer, and a falling
  604.     sequence of notes for an unsuccessfull file transfer.
  605.  
  606.     File transfers can also be initiated from an AREXX macro. Please
  607.     see the file HandShake_AREXX.doc for full details.
  608.  
  609.  
  610. Dialing the Phone.
  611.  
  612.     In order to dial a number from the dialing directory ( Menu
  613.  option "Dial Phone" ), click using the mouse on the small square
  614.  gadget immediately to the left of the number that you want to dial.
  615.  Clicking on the text of the number allows you to edit the entry, but
  616.  not to dial it.
  617.  
  618.     The dialing directory is saved to disk whenever you save the
  619.  parameters It is possible to have several dialing directories by
  620.  using different parameter files.
  621.     
  622.     Whenever HandShake goes into auto-dialing mode, it pops up a pair
  623.  of windows much like in file transfer mode to keep you informed of
  624.  progress. See the description in the file transfer section above.
  625.     
  626.     If the Audio bell feature is enabled, you will hear a four note
  627.     sequence to indicate that the connection has been completed.
  628.  
  629.     Dialing can also be initiated from an AEXX macro. See the file
  630.     HandShake_AREXX.doc for full details.
  631.  
  632. Format of dialing directory entries.
  633.  
  634.     A dialing directory entry has the following general format. The
  635.  parts in the square brackets are optional. The * at the end of the
  636.  line is used to indicate auto redialing.
  637.  
  638.     telephone_number[:baudrate[,data_bits[,parity[,stop_bits]]]]
  639.  [desc][*]
  640.  
  641.     Below are some sample dialing directory entries:
  642.  
  643.   123-4567                                  Simplest case. Dial the
  644.                                             number using the current
  645.                                             serial parameters.
  646.  
  647.   123-4567 Joe's BBS                        Same as above with a
  648.                                             description.
  649.  
  650.   123-4567 *                                Both of these will dial
  651.   123-4567 Joe's BBS*                       Until the other system
  652.                                             Answers.
  653.  
  654.   123-4567:1200                             Call the number changing
  655.                                             baud rate to 1200 if
  656.                                             necessary.
  657.  
  658.   123-4567:1200,8,n,1 Joe's BBS*            A biggie. Call Joe's
  659.                                             until it answers using
  660.                                             1200 baud, 8 data bits,
  661.                                             no parity and 1 stop
  662.                                             bit.
  663.                                                   
  664.     Valid parity characters are n=none, o=odd, e=even, m=mark and
  665.  s=space.
  666.  
  667. Interlace.
  668.  
  669.     The Half screen interlace mode is intended to give you a full 24
  670.  line VT100 Emulation in half a screen. This leaves you the other
  671.  half to do whatever you like, and still watch your terminal screen.
  672.  
  673.     The full screen interlace mode is useful in 132 column mode.
  674.     Readability of characters in interlaced mode may depend on your
  675.     selection of colors. (I find that black characters on a gray
  676.     background look just super ).
  677.  
  678.     The full screen 48 line interlace mode is useful to allow twice
  679.  as much information on teh screen. All escape sequences are extended
  680.  to work in the 48 line mode. This is useable with the new generation
  681.  of DEC editors like TPU, and others.
  682.     
  683. Multiple serial ports.
  684.  
  685.     HandShake version 2.20a supports the specification of alternative
  686.     device drivers. The default is DEVS:serial.device. Alternative
  687.     drivers can be specified from a menu item in the terminal menu,
  688.     the command line or ToolTypes Array from an Icon.
  689.     
  690.     The command line now supports the -d switch. To start Handshake
  691.     with the hypothetical driver devs:cereal.driver instead of
  692.     devs:serial.driver you could use the following command.
  693.     
  694.     HandShake -dcereal.device
  695.     
  696.     To select a device driver from an Icon, add a ToolTypes Array
  697.  like the one below.
  698.     
  699.     DRIVER=cereal.driver
  700.     
  701.     HandShake version 2.20a can be used with additional serial ports
  702.  if they are available on your Amiga. There is a new menu item in the
  703.  SETUP menu which allows you to switch serial ports on the fly from
  704.  within HandShake. If you save the parameters, Handshake will try to
  705.  use the same serial port and device driver next time you start it
  706.  with that parameter file unless you override the port selection.
  707.     
  708.     Overriding the serial port selection can be done in 2 ways from
  709.  the command line, and from an Icon.
  710.     
  711.     The command line now supports the -s switch. To start Handshake
  712.  with serial port 4 for instance, use the follwing command.
  713.     
  714.     HandShake -s4
  715.     
  716.     To select a serial port from an Icon, add a ToolTypes Array entry
  717.  like the one below.
  718.     
  719.     PORT=4
  720.  
  721.  
  722. HandShake VERSION HISTORY
  723.  
  724. Version 2.20c
  725.      - Added support for XPR external protocols.
  726.      - User can now specify which 8x8 font to use in Handshake.
  727. Version 2.20a
  728.      - Added support for multiple serial ports. HandShake now
  729.        supports unit numbers from 0 to 9. HandShake also supports
  730.        alternative device drivers.
  731.      - Adopted new HandShake Logo and therefore Changed the HandShake
  732.        icon. A thousand thanks to Art Lupinacci who designed and laid
  733.        out the Logo and disk labels for me.
  734.      - The .parms file format has been changed for this release. A
  735.        utility called CvtParms is provided to convert from the old
  736.        format to the new format. This format change was necessary
  737.        because I finally ran out of space for new stuff in the old
  738.        format.
  739.      - I would like to thank Brad Fowles who forced me to do this
  740.        AREXX port by publicly telling the Toronto Amiga Developer's
  741.        Forum that I had already done it (even though I had not a
  742.        single line of code written).
  743.      - Fixed bug which caused crash when there was not enough memory
  744.        to switch screen modes to 48 line or colour mode.
  745.      - Added support for the SS2 and SS3 single shift escape
  746.        sequences.
  747.      - Improved 132 column fonts.
  748.      - Added support for host printer control escape sequences. This
  749.        allows the host system to make use of the Amiga Parallel
  750.        printer if it is attached.
  751.      - HandShake now detaches when run from the command line. This
  752.        means that the CLI is not blocked if you don't type RUN
  753.        HandShake.
  754.      - Replaced error requesters with moveable AutoRequesters.
  755.      - Added AREXX support. HandShake now functions as both an AREXX
  756.        command host and an AREXX function host. The name of the
  757.        HandShake AREXX port is 'HANDSHAKE'.
  758.      - Added the AREXX menu to the titlebar menus.
  759.      - Added the RUN MACRO item to the AREXX  menu.
  760.      - Added the DOS Window item to the AREXX menu. This allows a
  761.        user to open a DOS window on the HandShake screen if he is
  762.        running ConMan on his system. This is especially useful with
  763.        AREXX if you are running the Wshell from Bill Hawes.
  764.      - Added the -m option to the command line to allow CLI users to
  765.        invoke AREXX macros when starting HandShake
  766.      - Added support for running an AREXX macro when starting
  767.        HandShake from a workbench icon. This was done by adding the
  768.        MACRO= ToolType.
  769.  
  770. Version 2.12a
  771.      - Cleaned up font support so that HandShake's fonts were not
  772.        visible to other applications in the system (i.e. Notepad).
  773.      - Fixed several downloadable font bugs which were reported by
  774.        Joe Trivers. Many thanks to Joe, who brought over a real VT220
  775.        to demonstrate these bugs.
  776.      - 24 line half screen mode stopped working in the last version
  777.        as a result of the interlace bug fix. This has been corrected.
  778.      - Last version was not linked with a tiny _main, as a result a
  779.        window opened on the workbench when HandShake was run from the
  780.        workbench.
  781.        This version is correctly linked.
  782.      - Changed the default foreground colour in the colour mode to 7
  783.        instead of 1.
  784.  
  785. Version 2.11a
  786.      - Fixed the "Interlace WorkBench" bug reported by Joanne Dow. If
  787.        you were running HandShake in 48 line mode with an interlaced
  788.        workbench and flipped back to the workbench with the Amiga-M,N
  789.        keys junk would be displayed.
  790.        
  791. Version 2.10a
  792.      - Set default VT220 character set mapping to gr<-g2<-DEC special
  793.        character set.
  794.      - Fixed and improved the VT220 soft font support.
  795.      - Changed Backspace handling so that it does now not wrap to
  796.        previous when at the start of a line.
  797.      - Added menu item to transmit the answer back message.
  798.      - ASCII screen images (printed or filed) no longer have trailing
  799.        blanks.
  800.      - Added close file option for the Save Screen submenu.
  801.      - ctrl-Z and ctrl-X now displayed as upside down ?.
  802.      - Fixed File IO Guru in BuildFullName.
  803.      - Cleaned up handling of IDCMP messages all over.
  804.      - Added default fourth colour for File requester. This can be
  805.        edited using the color edit in the project menu.
  806.      - Added menu item in the phone menu which lets the user dial
  807.        without first hanging up. This is required for some phone
  808.        systems which require multiple dials to reach a destination.
  809.        Also some people did not like the wait associated with waiting
  810.        for the phone to hang up.
  811.      - General cleanup of dialing code.
  812.      - Fixed bug in locked line requester which caused it to hang.
  813.      - Fixed receive buffer overflow problem. Receive buffer now
  814.        stands at 1536 bytes.
  815.      - Ymodem receives now correctly display received size when a
  816.        retransmitted block is encountered.
  817.      - Screen formats and colors are now set if a parameter file is
  818.        loaded once HandShake is already running.
  819.      - Added more VT220 control keys (3,4,5,6,7).
  820.      - Added support for mark and space parity.
  821.      - Added support for zero stop bits.
  822.      - File requesters for loading and saving parameters now only
  823.        display files which have a ".parms" extension. If a file name
  824.        without this extension is entered. it will be added.
  825.      - Removed WaitBOVP () calls and replaced them with WaitTOF ()
  826.        calls.    WaitBOVP () BUSY WAITS!! UGH.
  827.      - Replaced RJ's file requester with the ARP one. If ARP.library
  828.        is not available, fall back to old style plain requesters.
  829.      - Fixed the Special Graphics character set GURU reported by Joe
  830.        Trivers.
  831.      - Added direct screen print to the "Save Image" submenu.
  832.      - Added Close File menu option for "Save Image" submenu.
  833.      - The "New File" option in the "Save Image" memu item no longer
  834.        saves the first image. You must explicitly save all images now
  835.        with the Write Sreen submenu item.
  836.      - Corrected spelling for "Successful"
  837.      - Sundry other small fixes.
  838.  
  839. Version 2.00a
  840.      - Incredible code changes from last version.
  841.      - Full VT200 support (actually VT220 except for User Definable
  842.        Keys).
  843.      - Added RJ Mical's color editor so you can set and save colors.
  844.        See PROJECT menu.
  845.      - Added RJ Mical's file requester. All file names are now input
  846.        using this file requester.
  847.      - Made several code changes related to serial input to clean up
  848.        the lockup problem.
  849.      - See the new keyboard layout above. Some keys have moved to
  850.        accomodate VT200 support.
  851.      - Optional 8 color mode for "ANSI" BBSs.
  852.      - Ability to save ASCII screen images to a file. See the Screen
  853.        Image menu item in the Project Menu.
  854.      - Fixed Backspace and delete handling. No longer affects CTRL-h.
  855.        
  856. Version 1.60a    Jan/88
  857.      - Massive code cleanup. Defined function prototypes for all
  858.        functions in the source. Compiled with Lattice v4.0. Since
  859.        this version is such a major reworking of the source and
  860.        compiled with a new compiler, I would like to hear back from
  861.        users as quickly as possible if you encounter any bugs.
  862.      - Function prototyping turned up a bug in VT102 insert line
  863.        feature which could have caused trashing of very low memory.
  864.        Fixed.
  865.      - Tried to convert to 16 bit integers. Failed because of bugs in
  866.        Lattice v4.0. However the source is all set to go. Maybe next
  867.        release if Lattice fixes their bugs in getfnl(). This should
  868.        speed things up a bit more.
  869.      - Added support for the extra keys on the Amiga 500/2000 Keypad.
  870.        These can now be used as F1 through F4 and the VT100 keypad
  871.        comma key. See the text above.
  872.      - Added KERMIT 7 bit binary protocol for users who connect to
  873.        host system with 7 bit connections and want to transfer binary
  874.        files very slowly.
  875.      - Reversed PHONE and TRANSFER menus.
  876.      - Cleaned up XMODEM transfer protocol bugs. XMODEM wouldn't
  877.        switch from CRC to checksum properly.
  878.      - Improved dialing. HandShake now recognizes the baud rate that
  879.        a connection is made at from the CONNECT message. i.e. CONNECT
  880.        1200 or CONNECT 2400 etc. It also recognizes the return codes
  881.        BUSY, NO ANSWER, NO DIALTONE and NO CARRIER if one of these is
  882.        returned by the modem it is displayed for 1 second on the
  883.        STATUS line of the auto redial window. Any of these codes is
  884.        taken as a failure to connect.
  885.  
  886. Version 1.50a
  887.      - Added user definable function keys. keys F5 through F10 are
  888.        now available as user definable keys. See the documentation
  889.        above.
  890.      - Kermit File transfer protocol added. See documentation above.
  891.      - Some characters were getting lost after file transfers. This
  892.        is now fixed.
  893.  
  894. Version 1.42a
  895.  
  896.      - Fixed the horrid "Beep forever" bug.
  897.      - Fixed the rename command in EXEC_ME for HandShake.rev.
  898.  
  899. Version 1.41a
  900.      - Fixed bug in YMODEM Batch protocol. It would work with another
  901.        Amiga running HandShake, but not with any other YMODEM Batch
  902.        implementations.
  903.  
  904. Version 1.40a
  905.      - Fixed the horrible dialing bug which appeared in v1.30b. Boy
  906.        am I embarassed. Dialing would not work unless AUTO REDIAL was
  907.        selected.
  908.      - AmigaDos requesters now appear in the HandShake screen instead
  909.        of popping the Workbench screen to the front. Big improvement.
  910.      - YMODEM and YMODEM Batch file transfer protocols are here. See
  911.        the File transfer section of this document and the Binary
  912.        Protocol item of the TRANSFER menu.
  913.      - Added a bell. HandShake now beeps upon receipt of a BEL
  914.        character. HandShake also now gived an audio indication of
  915.        file transfer completion and connection in auto redial mode.
  916.        The user can select audio bell, visual bell, both or none. See
  917.        the new Bell Type item in the TERMINAL menu.
  918.      - Added the VT100 Margin bell feature. See the new Margin Bell
  919.        item in the TERMINALcmenu.
  920.      - Added a blinking/non-blinking option for the cursor. If you
  921.        are using a parameter file from a previous version of
  922.        HandShake, the cursor will not blink initially. Go to the
  923.        Cursor item of the TERMINAL menu and select blinking. Now save
  924.        your parameters. From now on the cursor will blink again when
  925.        you start HandShake.
  926.      - Speeded up CRC calculation for file transfers.
  927.      - Fixed a minor bug which caused XMODEM sends to always show 1
  928.        error even there had not been one. This did not affect the
  929.        transfer.
  930.      - Fixed a bug which sometimes caused inproper font selection
  931.        after going into VT52 mode and back out again.
  932.      - Fixed bug in UK Character set support.
  933.      - Speeded up CRC calculation for file transfers. I am now doing
  934.        bytewise instead of bitwise CRC calculation.
  935.  
  936. Version 1.30b
  937.     - Replaced the abort requesters with windows. The windows are
  938.       used to provide progress information about file transfers and
  939.       auto-dialing as well as serving as abort devices. To abort a
  940.       file transfer or auto-dialing just click on the close gadget of
  941.       the window in the HandShake screen.
  942.     - The windows described above are also duplicated on the
  943.       Workbench screen. This is so that you can do other things while
  944.       a large file transfer is in progress and not have to keep
  945.       flipping back to HandShake to see if it is finished yet. Same
  946.       for auto-dialing.
  947.     - Relinked with a "tiny" _main.o so that the lattice standard
  948.       input/output window no longer pops up in the workbench screen.
  949.     - Capture mode (ASCII Receive) can now remain active during
  950.       binary file transfers. HandShake will suspend it until the
  951.       transfer is over and then start it up again.
  952.     - Added XMODEM/CRC file transfer mode.
  953.  
  954. Version 1.21a
  955.     - Local echo mode did not work properly. This has been fixed.
  956.     - Reseting the terminal would sometimes leave a double cursor on
  957.       the screen. This has been fixed.
  958.     
  959. Version 1.20a
  960.  
  961.     - Improved Workbench interface. HandShake will now optionally
  962.       create Telephone icons for saved parameter files. This allows
  963.       the user to select which paramter file to use from the
  964.       Workbench. The icons can also be created in such a way that
  965.       HandShake will automatically start dialing a specified number
  966.       when it is invoked with that icon.
  967.     - Fixed a bug which caused XMODEM transmits to sometimes hang.
  968.     - Changed autodialing support so that it now works with modems
  969.       that report status while they are dialing (Like the Volksmodem
  970.       1200).
  971.     - Dialing destinations which contained spaces on the command line
  972.       did not work, even when enclosed in quotes. This has been
  973.       fixed.
  974.     - Selecting the Reset Terminal option from the menu or typing
  975.       Amiga-V would cause two cursors to appear on the screen. This
  976.       has been fixed.
  977.  
  978. Version 1.10a
  979.  
  980.     - At last, a real 132 columns instead of 128.
  981.     - Added some intelligence to the routines that display the
  982.       cursor. This yielded a 35% performance improvement. HandShake
  983.       now has an average throughput of about 875 characters per
  984.       second.
  985.     - Cleaned up parsing of command line parameters especially the
  986.       dialing directory entry.
  987.     - Put error checking into reading of parameter files. If the file
  988.       does not exist or is of the wrong size put up a requester
  989.       advising the user. If the default file HandShake.parms cannot
  990.       be found do not annoy the user with a requester (use the built
  991.       in defaults).
  992.     - The command line dialing direcotry entry is now case
  993.       insensitive.
  994.     - Added some register variables in several places. HandShake is
  995.       now about six percent faster because of this.
  996.     - Fixed a bug which caused the line attribute for the bottom line
  997.       to not be reset when the screen was cleared.
  998.     - Fixed a hideous bug which caused the input subtask to lock up
  999.       sometimes. This would appear to the user as a blank title bar.
  1000.       This would only happen if the user interface task sent a "go to
  1001.       sleep" message to the serial input task at the same instant
  1002.       that an IO completed, therefore this was more likely to happen
  1003.       at higher baud rates. Sorry about that one.
  1004.  
  1005. Version 1.02a ( not released to the public at large ).
  1006.     - Added command line parameters to specify parameter file to use,
  1007.       and to allow the user to specify a remote computer to dial from
  1008.       the command line.
  1009.     - Added 20 second dialing timeout to the dial timeout menu.
  1010.     - In order to abort redialing it was sometimes necessary to
  1011.       select the abort requester more than once. This is now fixed.
  1012.     - Moved File transfer and redialing abort requester to upper
  1013.       right portion of screen.
  1014.     - General cleanup of the file transfer code. Receiving to disk is
  1015.       now much faster. Transfer aborts now work porperly at high baud
  1016.       rates.
  1017.  
  1018. Version 1.01a
  1019.     - Auto redialing added.
  1020.     - Pulse/Dial menu option replaced with user definable dialing
  1021.       string.
  1022.     - Added menu item to allow user to specify backspace & del key
  1023.       operation.
  1024.     - Fixed bug which caused menus to not be updated after a reset if
  1025.       no parameter file was present.
  1026.  
  1027. Version 1.00a
  1028.     - HandShake Unleashed on an unsuspecting public. An historic
  1029.       Moment!
  1030.